package cn.tedu.tea.admin.server.product.service;

import cn.tedu.tea.admin.server.common.pojo.vo.PageData;
import cn.tedu.tea.admin.server.common.security.CurrentPrincipal;
import cn.tedu.tea.admin.server.product.pojo.param.GoodsAddNewParam;
import cn.tedu.tea.admin.server.product.pojo.vo.GoodsListItemVO;
import cn.tedu.tea.admin.server.product.pojo.vo.GoodsStandardVO;
import org.springframework.transaction.annotation.Transactional;

/**
 * 处理商品数据的业务接口
 *
 * @author java@tedu.cn
 * @version 1.0
 */
@Transactional
public interface IGoodsService {

    /**
     * 商品“是否上架”的状态文本
     */
    String[] STATUS_TEXT = {"下架", "上架"};

    /**
     * 发布商品
     *
     * @param currentPrincipal 当事人
     * @param remoteAddr       IP地址
     * @param goodsAddNewParam 新的商品数据
     */
    void addNew(CurrentPrincipal currentPrincipal, String remoteAddr, GoodsAddNewParam goodsAddNewParam);

    /**
     * 根据ID删除商品
     *
     * @param id 尝试删除的商品数据的ID
     */
    void delete(Long id);

    /**
     * 上架商品
     *
     * @param id 商品ID
     */
    void putOn(Long id);

    /**
     * 下架商品
     *
     * @param id 商品ID
     */
    void pullOff(Long id);

    /**
     * 根据ID查询商品详情
     *
     * @param id 商品ID
     * @return 匹配的商品数据详情，如果没有匹配的数据，则返回null
     */
    GoodsStandardVO getStandardById(Long id);

    /**
     * 查询商品列表，将使用默认的每页记录数
     *
     * @param pageNum 页码
     * @return 商品列表
     */
    PageData<GoodsListItemVO> list(Integer pageNum);

    /**
     * 查询商品列表
     *
     * @param pageNum  页码
     * @param pageSize 每页记录数
     * @return 商品列表
     */
    PageData<GoodsListItemVO> list(Integer pageNum, Integer pageSize);

    /**
     * 根据商品类别查询商品列表，将使用默认的每页记录数
     *
     * @param categoryId 商品类别的ID
     * @param pageNum    页码
     * @return 商品列表
     */
    PageData<GoodsListItemVO> listByCategoryId(Long categoryId, Integer pageNum);

    /**
     * 根据商品类别查询商品列表
     *
     * @param categoryId 商品类别的ID
     * @param pageNum    页码
     * @param pageSize   每页记录数
     * @return 商品列表
     */
    PageData<GoodsListItemVO> listByCategoryId(Long categoryId, Integer pageNum, Integer pageSize);

}
